home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / setpgid.z / setpgid
Encoding:
Text File  |  2001-04-17  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssseeeettttppppggggiiiidddd((((2222))))                                                          sssseeeettttppppggggiiiidddd((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_eeee_tttt_pppp_gggg_iiii_dddd - set process group ID
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  14.  
  15.      _iiii_nnnn_tttt _ssss_eeee_tttt_pppp_gggg_iiii_dddd_((((_pppp_iiii_dddd______tttt _pppp_iiii_dddd_,,,, _pppp_iiii_dddd______tttt _pppp_gggg_iiii_dddd_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _ssss_eeee_tttt_pppp_gggg_iiii_dddd sets the process group ID of the process with ID _p_i_d to _p_g_i_d.  If
  19.      _p_g_i_d is equal to _p_i_d,  the process becomes a process group leader.  If
  20.      _p_g_i_d is not equal to _p_i_d, the process becomes a member of an existing
  21.      process group.
  22.  
  23.      If _p_i_d is equal to 0, the process ID of the calling process is used.  If
  24.      _p_g_i_d is equal to 0, the process specified by _p_i_d becomes a process group
  25.      leader.
  26.  
  27.      _ssss_eeee_tttt_pppp_gggg_iiii_dddd fails and returns an error if one or more of the following are
  28.      true:
  29.  
  30.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS         _p_i_d matches the process ID of a child process of the
  31.                     calling process and the child process has successfully
  32.                     executed an _eeee_xxxx_eeee_cccc(2) function.
  33.  
  34.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS         In the Trusted IRIX environment, the Mandatory Access
  35.                     Control (MAC) label of the calling process is not equal to
  36.                     the MAC label of _p_i_d and the calling process does not have
  37.                     the CCCCAAAAPPPP____MMMMAAAACCCC____RRRREEEEAAAADDDD and CCCCAAAAPPPP____MMMMAAAACCCC____WWWWRRRRIIIITTTTEEEE capabilities(4).
  38.  
  39.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         _p_g_i_d is not a valid process group id value.
  40.  
  41.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The calling process has a controlling terminal that does
  42.                     not support job control.
  43.  
  44.      _EEEE_PPPP_EEEE_RRRR_MMMM          The process indicated by the _p_i_d argument is a session
  45.                     leader.
  46.  
  47.      _EEEE_PPPP_EEEE_RRRR_MMMM          _p_i_d matches the process ID of a child process of the
  48.                     calling process and the child process is not in the same
  49.                     session as the calling process.
  50.  
  51.      _EEEE_PPPP_EEEE_RRRR_MMMM          _p_g_i_d does not match the process ID of the process
  52.                     indicated by the _p_i_d argument and there is no process with
  53.                     a process group ID that matches _p_g_i_d in the same session
  54.                     as the calling process.
  55.  
  56.      _EEEE_SSSS_RRRR_CCCC_HHHH          _p_i_d does not match the process ID of the calling process
  57.                     or of a child process of the calling process.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssseeeettttppppggggiiiidddd((((2222))))                                                          sssseeeettttppppggggiiiidddd((((2222))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      _eeee_xxxx_eeee_cccc(2), _eeee_xxxx_iiii_tttt(2), _ffff_oooo_rrrr_kkkk(2), _gggg_eeee_tttt_pppp_iiii_dddd(2), _gggg_eeee_tttt_pppp_gggg_iiii_dddd(2), _ssss_eeee_tttt_ssss_iiii_dddd(2),
  76.      _tttt_cccc_ssss_eeee_tttt_pppp_gggg_rrrr_pppp(3T).  _cccc_aaaa_pppp_aaaa_bbbb_iiii_llll_iiii_tttt_iiii_eeee_ssss(4).  _dddd_oooo_mmmm_iiii_nnnn_aaaa_nnnn_cccc_eeee(5).
  77.  
  78. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  79.      Upon successful completion, _ssss_eeee_tttt_pppp_gggg_iiii_dddd returns a value of 0.  Otherwise, a
  80.      value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.